home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / lib / c / stdlib / strtod.man < prev    next >
Encoding:
Text File  |  1989-03-22  |  2.0 KB  |  55 lines
  1. ' Copyright 1989 Regents of the University of California
  2. ' Permission to use, copy, modify, and distribute this
  3. ' documentation for any purpose and without fee is hereby
  4. ' granted, provided that this notice appears in all copies.
  5. ' The University of California makes no representations about
  6. ' the suitability of this material for any purpose.  It is
  7. ' provided "as is" without express or implied warranty.
  8. ' 
  9. ' $Header: /sprite/src/lib/c/stdlib/RCS/strtod.man,v 1.1 89/01/05 18:00:47 ouster Exp $ SPRITE (Berkeley)
  10. ' 
  11. .so \*(]ltmac.sprite
  12. .HS strtod cmds
  13. .BS
  14. .SH NAME
  15. strtod \- Convert character string to floating-point number
  16. .SH SYNOPSIS
  17. .nf
  18. \fB#include <stdlib.h>
  19.  
  20. \fBdouble
  21. \fBstrtod(\fIstring\fR, \fIendPtr\fR)
  22. .SH ARGUMENTS
  23. .AS "char *" endPtr
  24. .AP char *string in
  25. String containing ASCII representation of floating-point number.
  26. .AP char **endPtr out
  27. If not \fBNULL\fR, gives address of pointer to fill in with address of
  28. first character not forming part of number.
  29. .BE
  30.  
  31. .SH DESCRIPTION
  32. .PP
  33. The \fBstrtod\fR procedure parses a floating-point number in ASCII
  34. representation and returns a \fBdouble\fR result containing the
  35. binary form of the number.  The expected
  36. form of \fIstring\fR is an optional plus or minus sign, then a sequence
  37. of decimal digits optionally containing a decimal point, then an
  38. optional exponent part.  If the exponent part is present, it consists
  39. of the letter \fBE\fR (or \fBe\fR), then an optional plus or minus sign,
  40. then a sequence of decimal digits.  The entire floating-point number
  41. may be preceded by any amount of white space (as defined by the
  42. \fBisspace\fR procedure).
  43. .PP
  44. \fIStrtod\fR examines as many characters as possible from \fIstring\fR
  45. while still obeying the syntax rules given above.
  46. If \fIendPtr\fR is not \fBNULL\fR, then the address of the first
  47. character following the floating-point number is stored in \fI*endPtr\fR.
  48. .PP
  49. If \fIstring\fR does not refer to a floating-point number in the format
  50. given above, then zero is returned and \fIstring\fR will be stored at
  51. \fI*endPtr\fR.
  52.  
  53. .SH KEYWORDS
  54. convert, floating-point, string
  55.